<!DOCTYPE html>
<html lang="zh-Hans" dir="ltr">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,initial-scale=1">
    <title>部署到 GitHub Pages | VitePress基础框架</title>
    <meta name="description" content="VitePress基础框架的站点描述">
    <meta name="generator" content="VitePress v1.3.4">
    <link rel="preload stylesheet" href="/vitepress-template-public/assets/style.BlgVYu-Y.css" as="style">
    <script type="module" src="/vitepress-template-public/assets/chunks/metadata.e7f3cd1f.js"></script>
    <script type="module" src="/vitepress-template-public/assets/app.B7Bvz4Bc.js"></script>
    <link rel="preload" href="/vitepress-template-public/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
    <link rel="modulepreload" href="/vitepress-template-public/assets/chunks/theme.B1DMWA2k.js">
    <link rel="modulepreload" href="/vitepress-template-public/assets/chunks/framework.D5O-cTmz.js">
    <link rel="modulepreload" href="/vitepress-template-public/assets/guide_github-pages.md.QveD5bSh.lean.js">
    <link rel="icon" type="image/svg+xml" href="./logo/vitepress-logo-mini.svg">
    <link rel="icon" type="image/png" href="./logo/vitepress-logo-mini.png">
    <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
    <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
  </head>
  <body>
    <div id="app"><div class="Layout" data-v-b928bd87><!--[--><!--]--><!--[--><span tabindex="-1" data-v-7de6d21b></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-7de6d21b> Skip to content </a><!--]--><!----><header class="VPNav" data-v-b928bd87 data-v-7614e298><div class="VPNavBar" data-v-7614e298 data-v-4a78392f><div class="wrapper" data-v-4a78392f><div class="container" data-v-4a78392f><div class="title" data-v-4a78392f><div class="VPNavBarTitle has-sidebar" data-v-4a78392f data-v-a1bbf3b8><a class="title" href="/vitepress-template-public/" data-v-a1bbf3b8><!--[--><!--]--><!--[--><img class="VPImage logo" src="/vitepress-template-public/logo/vitepress-logo-mini.svg" width="24" height="24" alt data-v-5f4c361e><!--]--><span data-v-a1bbf3b8>VitePress基础框架</span><!--[--><!--]--></a></div></div><div class="content" data-v-4a78392f><div class="content-body" data-v-4a78392f><!--[--><!--]--><div class="VPNavBarSearch search" data-v-4a78392f><!----></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-4a78392f data-v-1eb62029><span id="main-nav-aria-label" class="visually-hidden" data-v-1eb62029> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/vitepress-template-public/guide/install" tabindex="0" data-v-1eb62029 data-v-c4db28c0><!--[--><span data-v-c4db28c0>教程</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/vitepress-template-public/examples/markdown" tabindex="0" data-v-1eb62029 data-v-c4db28c0><!--[--><span data-v-c4db28c0>示例</span><!--]--></a><!--]--><!--[--><div class="VPFlyout VPNavBarMenuGroup" data-v-1eb62029 data-v-8c3a7de4><button type="button" class="button" aria-haspopup="true" aria-expanded="false" data-v-8c3a7de4><span class="text" data-v-8c3a7de4><!----><span data-v-8c3a7de4>下拉导航</span><span class="vpi-chevron-down text-icon" data-v-8c3a7de4></span></span></button><div class="menu" data-v-8c3a7de4><div class="VPMenu" data-v-8c3a7de4 data-v-387194d2><div class="items" data-v-387194d2><!--[--><!--[--><div class="VPMenuGroup" data-v-387194d2 data-v-91ebaee2><p class="title" data-v-91ebaee2>下拉导航标题</p><!--[--><!--[--><div class="VPMenuLink" data-v-91ebaee2 data-v-f484e6ee><a class="VPLink link vp-external-link-icon" href="https://github.com/dcdy/vitepress-template/edit/main/docs/.vitepress/config.mts" target="_blank" rel="noreferrer" data-v-f484e6ee><!--[-->子项A<!--]--></a></div><!--]--><!--[--><div class="VPMenuLink" data-v-91ebaee2 data-v-f484e6ee><a class="VPLink link vp-external-link-icon" href="https://gitee.com/xia_mei_ting/vitepress-template/blob/main/docs/.vitepress/config.mts" target="_blank" rel="noreferrer" data-v-f484e6ee><!--[-->子项B<!--]--></a></div><!--]--><!--]--></div><!--]--><!--]--></div><!--[--><!--]--></div></div></div><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-4a78392f data-v-429aef54><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-429aef54 data-v-51f78c2c data-v-7bf662e2><span class="check" data-v-7bf662e2><span class="icon" data-v-7bf662e2><!--[--><span class="vpi-sun sun" data-v-51f78c2c></span><span class="vpi-moon moon" data-v-51f78c2c></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-4a78392f data-v-efa425a3 data-v-c2882db4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/dcdy/vitepress-template" aria-label="github" target="_blank" rel="noopener" data-v-c2882db4 data-v-788a0e61><span class="vpi-social-github" /></a><a class="VPSocialLink no-icon" href="https://gitee.com/xia_mei_ting/vitepress-template" aria-label target="_blank" rel="noopener" data-v-c2882db4 data-v-788a0e61><svg t="1727428813465" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="2268" width="200" height="200"><path d="M512 1024C229.222 1024 0 794.778 0 512S229.222 0 512 0s512 229.222 512 512-229.222 512-512 512z m259.149-568.883h-290.74a25.293 25.293 0 0 0-25.292 25.293l-0.026 63.206c0 13.952 11.315 25.293 25.267 25.293h177.024c13.978 0 25.293 11.315 25.293 25.267v12.646a75.853 75.853 0 0 1-75.853 75.853h-240.23a25.293 25.293 0 0 1-25.267-25.293V417.203a75.853 75.853 0 0 1 75.827-75.853h353.946a25.293 25.293 0 0 0 25.267-25.292l0.077-63.207a25.293 25.293 0 0 0-25.268-25.293H417.152a189.62 189.62 0 0 0-189.62 189.645V771.15c0 13.977 11.316 25.293 25.294 25.293h372.94a170.65 170.65 0 0 0 170.65-170.65V480.384a25.293 25.293 0 0 0-25.293-25.267z" fill="#C71D23" p-id="2269"></path></svg></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-4a78392f data-v-12aa81bd data-v-8c3a7de4><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-8c3a7de4><span class="vpi-more-horizontal icon" data-v-8c3a7de4></span></button><div class="menu" data-v-8c3a7de4><div class="VPMenu" data-v-8c3a7de4 data-v-387194d2><!----><!--[--><!--[--><!----><div class="group" data-v-12aa81bd><div class="item appearance" data-v-12aa81bd><p class="label" data-v-12aa81bd>主题</p><div class="appearance-action" data-v-12aa81bd><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-12aa81bd data-v-51f78c2c data-v-7bf662e2><span class="check" data-v-7bf662e2><span class="icon" data-v-7bf662e2><!--[--><span class="vpi-sun sun" data-v-51f78c2c></span><span class="vpi-moon moon" data-v-51f78c2c></span><!--]--></span></span></button></div></div></div><div class="group" data-v-12aa81bd><div class="item social-links" data-v-12aa81bd><div class="VPSocialLinks social-links-list" data-v-12aa81bd data-v-c2882db4><!--[--><a class="VPSocialLink no-icon" href="https://github.com/dcdy/vitepress-template" aria-label="github" target="_blank" rel="noopener" data-v-c2882db4 data-v-788a0e61><span class="vpi-social-github" /></a><a class="VPSocialLink no-icon" href="https://gitee.com/xia_mei_ting/vitepress-template" aria-label target="_blank" rel="noopener" data-v-c2882db4 data-v-788a0e61><svg t="1727428813465" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="2268" width="200" height="200"><path d="M512 1024C229.222 1024 0 794.778 0 512S229.222 0 512 0s512 229.222 512 512-229.222 512-512 512z m259.149-568.883h-290.74a25.293 25.293 0 0 0-25.292 25.293l-0.026 63.206c0 13.952 11.315 25.293 25.267 25.293h177.024c13.978 0 25.293 11.315 25.293 25.267v12.646a75.853 75.853 0 0 1-75.853 75.853h-240.23a25.293 25.293 0 0 1-25.267-25.293V417.203a75.853 75.853 0 0 1 75.827-75.853h353.946a25.293 25.293 0 0 0 25.267-25.292l0.077-63.207a25.293 25.293 0 0 0-25.268-25.293H417.152a189.62 189.62 0 0 0-189.62 189.645V771.15c0 13.977 11.316 25.293 25.294 25.293h372.94a170.65 170.65 0 0 0 170.65-170.65V480.384a25.293 25.293 0 0 0-25.293-25.267z" fill="#C71D23" p-id="2269"></path></svg></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-4a78392f data-v-8aa5fe9b><span class="container" data-v-8aa5fe9b><span class="top" data-v-8aa5fe9b></span><span class="middle" data-v-8aa5fe9b></span><span class="bottom" data-v-8aa5fe9b></span></span></button></div></div></div></div><div class="divider" data-v-4a78392f><div class="divider-line" data-v-4a78392f></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-b928bd87 data-v-84e6a0db><div class="container" data-v-84e6a0db><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-84e6a0db><span class="vpi-align-left menu-icon" data-v-84e6a0db></span><span class="menu-text" data-v-84e6a0db>菜单</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-84e6a0db data-v-39065feb><button data-v-39065feb>回到顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-b928bd87 data-v-754706ac><div class="curtain" data-v-754706ac></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-754706ac><span class="visually-hidden" id="sidebar-aria-label" data-v-754706ac> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-a51db1f1><section class="VPSidebarItem level-0 collapsible" data-v-a51db1f1 data-v-39a5995e><div class="item" role="button" tabindex="0" data-v-39a5995e><div class="indicator" data-v-39a5995e></div><h2 class="text" data-v-39a5995e>简介</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-39a5995e><span class="vpi-chevron-right caret-icon" data-v-39a5995e></span></div></div><div class="items" data-v-39a5995e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-39a5995e data-v-39a5995e><div class="item" data-v-39a5995e><div class="indicator" data-v-39a5995e></div><a class="VPLink link link" href="/vitepress-template-public/guide/install" data-v-39a5995e><!--[--><p class="text" data-v-39a5995e>安装</p><!--]--></a><!----></div><!----></div><section class="VPSidebarItem level-1" data-v-39a5995e data-v-39a5995e><div class="item" role="button" tabindex="0" data-v-39a5995e><div class="indicator" data-v-39a5995e></div><h3 class="text" data-v-39a5995e>配置</h3><!----></div><div class="items" data-v-39a5995e><!--[--><div class="VPSidebarItem level-2 is-link" data-v-39a5995e data-v-39a5995e><div class="item" data-v-39a5995e><div class="indicator" data-v-39a5995e></div><a class="VPLink link link" href="/vitepress-template-public/guide/config-home" data-v-39a5995e><!--[--><p class="text" data-v-39a5995e>首页配置</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-2 is-link" data-v-39a5995e data-v-39a5995e><div class="item" data-v-39a5995e><div class="indicator" data-v-39a5995e></div><a class="VPLink link link" href="/vitepress-template-public/guide/config-doc" data-v-39a5995e><!--[--><p class="text" data-v-39a5995e>文档配置</p><!--]--></a><!----></div><!----></div><!--]--></div></section><!--]--></div></section></div><div class="no-transition group" data-v-a51db1f1><section class="VPSidebarItem level-0 collapsible has-active" data-v-a51db1f1 data-v-39a5995e><div class="item" role="button" tabindex="0" data-v-39a5995e><div class="indicator" data-v-39a5995e></div><h2 class="text" data-v-39a5995e>部署</h2><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-39a5995e><span class="vpi-chevron-right caret-icon" data-v-39a5995e></span></div></div><div class="items" data-v-39a5995e><!--[--><div class="VPSidebarItem level-1 is-link" data-v-39a5995e data-v-39a5995e><div class="item" data-v-39a5995e><div class="indicator" data-v-39a5995e></div><a class="VPLink link link" href="/vitepress-template-public/guide/github-pages" data-v-39a5995e><!--[--><p class="text" data-v-39a5995e>Github Pages</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-b928bd87 data-v-5d97ccec><div class="VPDoc has-sidebar has-aside" data-v-5d97ccec data-v-184b3be7><!--[--><!--]--><div class="container" data-v-184b3be7><div class="aside" data-v-184b3be7><div class="aside-curtain" data-v-184b3be7></div><div class="aside-container" data-v-184b3be7><div class="aside-content" data-v-184b3be7><div class="VPDocAside" data-v-184b3be7 data-v-f6e4fd1a><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-f6e4fd1a data-v-c582f5e1><div class="content" data-v-c582f5e1><div class="outline-marker" data-v-c582f5e1></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-c582f5e1>页面导航</div><ul class="VPDocOutlineItem root" data-v-c582f5e1 data-v-9dd79648><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-f6e4fd1a></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-184b3be7><div class="content-container" data-v-184b3be7><!--[--><!--]--><main class="main" data-v-184b3be7><div style="position:relative;" class="vp-doc _vitepress-template-public_guide_github-pages external-link-icon-enabled" data-v-184b3be7><div><h1 id="部署到-github-pages" tabindex="-1">部署到 GitHub Pages <a class="header-anchor" href="#部署到-github-pages" aria-label="Permalink to &quot;部署到 GitHub Pages&quot;">​</a></h1><div class="info custom-block"><p class="custom-block-title">参考链接</p><p><a href="https://vitepress.dev/zh/guide/deploy#github-pages" target="_blank" rel="noreferrer">https://vitepress.dev/zh/guide/deploy#github-pages</a><a href="https://vitepress.dev/zh/guide/deploy#setting-a-public-base-path" target="_blank" rel="noreferrer">https://vitepress.dev/zh/guide/deploy#setting-a-public-base-path</a></p></div><h2 id="_1-新建-github-workflows-deploy-yml-文件" tabindex="-1">1.新建.github/workflows/deploy.yml 文件 <a class="header-anchor" href="#_1-新建-github-workflows-deploy-yml-文件" aria-label="Permalink to &quot;1.新建.github/workflows/deploy.yml 文件&quot;">​</a></h2><div class="language-yml line-numbers-mode"><button title="复制代码" class="copy"></button><span class="lang">yml</span><pre class="shiki one-dark-pro vp-code" tabindex="0"><code><span class="line"><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Deploy Pages</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;"># 触发条件，push到main分支或者pull request到main分支</span></span>
<span class="line"><span style="color:#D19A66;">on</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">    push</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">        branches</span><span style="color:#ABB2BF;">: [</span><span style="color:#98C379;">main</span><span style="color:#ABB2BF;">]</span></span>
<span class="line"><span style="color:#E06C75;">    pull_request</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">        branches</span><span style="color:#ABB2BF;">: [</span><span style="color:#98C379;">main</span><span style="color:#ABB2BF;">]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">    # 支持手动在工作流上触发</span></span>
<span class="line"><span style="color:#E06C75;">    workflow_dispatch</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;"># 设置时区</span></span>
<span class="line"><span style="color:#E06C75;">env</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">    TZ</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Asia/Shanghai</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;"># 权限设置</span></span>
<span class="line"><span style="color:#E06C75;">permissions</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">    # 允许读取仓库内容的权限。</span></span>
<span class="line"><span style="color:#E06C75;">    contents</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">read</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">    # 允许写入 GitHub Pages 的权限。</span></span>
<span class="line"><span style="color:#E06C75;">    pages</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">write</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">    # 允许写入 id-token 的权限。</span></span>
<span class="line"><span style="color:#E06C75;">    id-token</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">write</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;"># 并发控制配置</span></span>
<span class="line"><span style="color:#E06C75;">concurrency</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">    group</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">pages</span></span>
<span class="line"><span style="color:#E06C75;">    cancel-in-progress</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">false</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;"># 定义执行任务</span></span>
<span class="line"><span style="color:#E06C75;">jobs</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">    # 构建任务</span></span>
<span class="line"><span style="color:#E06C75;">    build</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">        runs-on</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">ubuntu-latest</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">        # node v20 运行</span></span>
<span class="line"><span style="color:#E06C75;">        strategy</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">            matrix</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">                node-version</span><span style="color:#ABB2BF;">: [</span><span style="color:#D19A66;">20</span><span style="color:#ABB2BF;">]</span></span>
<span class="line"></span>
<span class="line"><span style="color:#E06C75;">        steps</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">            # 拉取代码</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Checkout</span></span>
<span class="line"><span style="color:#E06C75;">              uses</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">actions/checkout@v3</span></span>
<span class="line"><span style="color:#E06C75;">              with</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">                  # 保留 Git 信息</span></span>
<span class="line"><span style="color:#E06C75;">                  fetch-depth</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">0</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">            # 设置使用 Node.js 版本</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Use Node.js ${{ matrix.node-version }}</span></span>
<span class="line"><span style="color:#E06C75;">              uses</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">actions/setup-node@v3</span></span>
<span class="line"><span style="color:#E06C75;">              with</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">                  node-version</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">${{ matrix.node-version }}</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">            # 使用 最新的 PNPM</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">            # 你也可以指定为具体的版本</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">uses</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">pnpm/action-setup@v2</span></span>
<span class="line"><span style="color:#E06C75;">              name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Install pnpm</span></span>
<span class="line"><span style="color:#E06C75;">              with</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">                  version</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">latest</span></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">                  # version: 9</span></span>
<span class="line"><span style="color:#E06C75;">                  run_install</span><span style="color:#ABB2BF;">: </span><span style="color:#D19A66;">false</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">              # 安装依赖</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Install dependencies</span></span>
<span class="line"><span style="color:#E06C75;">              run</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">pnpm install --frozen-lockfile</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">              # 构建项目</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Build blog project</span></span>
<span class="line"><span style="color:#E06C75;">              run</span><span style="color:#ABB2BF;">: </span><span style="color:#C678DD;">|</span></span>
<span class="line"><span style="color:#98C379;">                  echo ${{ github.workspace }}</span></span>
<span class="line"><span style="color:#98C379;">                  pnpm build</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">              # 资源拷贝</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Build with Jekyll</span></span>
<span class="line"><span style="color:#E06C75;">              uses</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">actions/jekyll-build-pages@v1</span></span>
<span class="line"><span style="color:#E06C75;">              with</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">                  source</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">./docs/.vitepress/dist</span></span>
<span class="line"><span style="color:#E06C75;">                  destination</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">./_site</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">              # 上传 _site 的资源，用于后续部署</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Upload artifact</span></span>
<span class="line"><span style="color:#E06C75;">              uses</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">actions/upload-pages-artifact@v3</span></span>
<span class="line"></span>
<span class="line"><span style="color:#7F848E;font-style:italic;">    # 部署任务</span></span>
<span class="line"><span style="color:#E06C75;">    deploy</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">        environment</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#E06C75;">            name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">github-pages</span></span>
<span class="line"><span style="color:#E06C75;">            url</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">${{ steps.deployment.outputs.page_url }}</span></span>
<span class="line"><span style="color:#E06C75;">        runs-on</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">ubuntu-latest</span></span>
<span class="line"><span style="color:#E06C75;">        needs</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">build</span></span>
<span class="line"><span style="color:#E06C75;">        steps</span><span style="color:#ABB2BF;">:</span></span>
<span class="line"><span style="color:#ABB2BF;">            - </span><span style="color:#E06C75;">name</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">Deploy to GitHub Pages</span></span>
<span class="line"><span style="color:#E06C75;">              id</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">deployment</span></span>
<span class="line"><span style="color:#E06C75;">              uses</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">actions/deploy-pages@v4</span></span></code></pre><div class="line-numbers-wrapper" aria-hidden="true"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br><span class="line-number">4</span><br><span class="line-number">5</span><br><span class="line-number">6</span><br><span class="line-number">7</span><br><span class="line-number">8</span><br><span class="line-number">9</span><br><span class="line-number">10</span><br><span class="line-number">11</span><br><span class="line-number">12</span><br><span class="line-number">13</span><br><span class="line-number">14</span><br><span class="line-number">15</span><br><span class="line-number">16</span><br><span class="line-number">17</span><br><span class="line-number">18</span><br><span class="line-number">19</span><br><span class="line-number">20</span><br><span class="line-number">21</span><br><span class="line-number">22</span><br><span class="line-number">23</span><br><span class="line-number">24</span><br><span class="line-number">25</span><br><span class="line-number">26</span><br><span class="line-number">27</span><br><span class="line-number">28</span><br><span class="line-number">29</span><br><span class="line-number">30</span><br><span class="line-number">31</span><br><span class="line-number">32</span><br><span class="line-number">33</span><br><span class="line-number">34</span><br><span class="line-number">35</span><br><span class="line-number">36</span><br><span class="line-number">37</span><br><span class="line-number">38</span><br><span class="line-number">39</span><br><span class="line-number">40</span><br><span class="line-number">41</span><br><span class="line-number">42</span><br><span class="line-number">43</span><br><span class="line-number">44</span><br><span class="line-number">45</span><br><span class="line-number">46</span><br><span class="line-number">47</span><br><span class="line-number">48</span><br><span class="line-number">49</span><br><span class="line-number">50</span><br><span class="line-number">51</span><br><span class="line-number">52</span><br><span class="line-number">53</span><br><span class="line-number">54</span><br><span class="line-number">55</span><br><span class="line-number">56</span><br><span class="line-number">57</span><br><span class="line-number">58</span><br><span class="line-number">59</span><br><span class="line-number">60</span><br><span class="line-number">61</span><br><span class="line-number">62</span><br><span class="line-number">63</span><br><span class="line-number">64</span><br><span class="line-number">65</span><br><span class="line-number">66</span><br><span class="line-number">67</span><br><span class="line-number">68</span><br><span class="line-number">69</span><br><span class="line-number">70</span><br><span class="line-number">71</span><br><span class="line-number">72</span><br><span class="line-number">73</span><br><span class="line-number">74</span><br><span class="line-number">75</span><br><span class="line-number">76</span><br><span class="line-number">77</span><br><span class="line-number">78</span><br><span class="line-number">79</span><br><span class="line-number">80</span><br><span class="line-number">81</span><br><span class="line-number">82</span><br><span class="line-number">83</span><br><span class="line-number">84</span><br><span class="line-number">85</span><br><span class="line-number">86</span><br><span class="line-number">87</span><br><span class="line-number">88</span><br><span class="line-number">89</span><br><span class="line-number">90</span><br><span class="line-number">91</span><br><span class="line-number">92</span><br><span class="line-number">93</span><br><span class="line-number">94</span><br><span class="line-number">95</span><br><span class="line-number">96</span><br></div></div><h2 id="_2-config-mts-文件内添加-base-指定项目名" tabindex="-1">2.config.mts 文件内添加 base 指定项目名 <a class="header-anchor" href="#_2-config-mts-文件内添加-base-指定项目名" aria-label="Permalink to &quot;2.config.mts 文件内添加 base 指定项目名&quot;">​</a></h2><div class="warning custom-block"><p class="custom-block-title">注意</p><p>如果打包部署后的站点没有样式，就是 base 配置的不对</p></div><div class="language-js line-numbers-mode"><button title="复制代码" class="copy"></button><span class="lang">js</span><pre class="shiki one-dark-pro vp-code" tabindex="0"><code><span class="line"><span style="color:#C678DD;">export</span><span style="color:#C678DD;"> default</span><span style="color:#61AFEF;"> defineConfig</span><span style="color:#ABB2BF;">({</span></span>
<span class="line highlighted"><span style="color:#E06C75;">	base</span><span style="color:#ABB2BF;">: </span><span style="color:#98C379;">&#39;/vitepress-template/&#39;</span><span style="color:#ABB2BF;">, </span><span style="color:#7F848E;font-style:italic;">// vitepress-template为自己的项目名称</span></span>
<span class="line"><span style="color:#ABB2BF;">});</span></span></code></pre><div class="line-numbers-wrapper" aria-hidden="true"><span class="line-number">1</span><br><span class="line-number">2</span><br><span class="line-number">3</span><br></div></div><h2 id="_3-配置-github" tabindex="-1">3.配置 github <a class="header-anchor" href="#_3-配置-github" aria-label="Permalink to &quot;3.配置 github&quot;">​</a></h2><p><span class="img-wrapper"><img src="https://cdn.jsdelivr.net/gh/dcdy/image/img/image-20240924112324556.png" alt="image-20240924112324556" class="img-loading" onload="this.classList.remove(&#39;img-loading&#39;)" onerror="this.classList.remove(&#39;img-loading&#39;); this.classList.add(&#39;img-error&#39;)"></span></p><h2 id="_4-pnpm-build-打包-打包后将更改推送到-main-分支并等待-github-action-工作流完成。" tabindex="-1">4.pnpm build 打包，打包后将更改推送到 main 分支并等待 GitHub Action 工作流完成。 <a class="header-anchor" href="#_4-pnpm-build-打包-打包后将更改推送到-main-分支并等待-github-action-工作流完成。" aria-label="Permalink to &quot;4.pnpm build 打包，打包后将更改推送到 main 分支并等待 GitHub Action 工作流完成。&quot;">​</a></h2><h2 id="_5-部署完成后-有代码更新时-push-推送到-main-分支-会自动触发-github-action-工作流更新线上样式。" tabindex="-1">5.部署完成后，有代码更新时 push 推送到 main 分支，会自动触发 GitHub Action 工作流更新线上样式。 <a class="header-anchor" href="#_5-部署完成后-有代码更新时-push-推送到-main-分支-会自动触发-github-action-工作流更新线上样式。" aria-label="Permalink to &quot;5.部署完成后，有代码更新时 push 推送到 main 分支，会自动触发 GitHub Action 工作流更新线上样式。&quot;">​</a></h2></div></div></main><footer class="VPDocFooter" data-v-184b3be7 data-v-418b990b><!--[--><!--]--><div class="edit-info" data-v-418b990b><div class="edit-link" data-v-418b990b><a class="VPLink link vp-external-link-icon no-icon edit-link-button" href="https://github.com/dcdy/vitepress-template/edit/main/docs/guide/github-pages.md" target="_blank" rel="noreferrer" data-v-418b990b><!--[--><span class="vpi-square-pen edit-link-icon" data-v-418b990b></span> 在 GitHub 上编辑此页面<!--]--></a></div><div class="last-updated" data-v-418b990b><p class="VPLastUpdated" data-v-418b990b data-v-6a80e2fe>最后更新于: <time datetime="2024-12-03T05:11:06.000Z" data-v-6a80e2fe></time></p></div></div><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-418b990b><span class="visually-hidden" id="doc-footer-aria-label" data-v-418b990b>Pager</span><div class="pager" data-v-418b990b><a class="VPLink link pager-link prev" href="/vitepress-template-public/guide/config-doc" data-v-418b990b><!--[--><span class="desc" data-v-418b990b>上一页</span><span class="title" data-v-418b990b>文档配置</span><!--]--></a></div><div class="pager" data-v-418b990b><!----></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-b928bd87 data-v-fdadc4f9><div class="container" data-v-fdadc4f9><p class="message" data-v-fdadc4f9>基于MIT许可发布</p><p class="copyright" data-v-fdadc4f9>版权所有 © 2024 dcdyxmt@163.com</p></div></footer><!--[--><!--]--></div></div>
    
    
  </body>
</html>